home *** CD-ROM | disk | FTP | other *** search
/ Amiga Collections: Topik / Topik - Disk 04 - Disk and Technical Stuff (19xx)(Topik Public Domain)(PD)[WB].zip / Topik - Disk 04 - Disk and Technical Stuff (19xx)(Topik Public Domain)(PD)[WB].adf / DiskEds / DiskX.docs < prev    next >
Text File  |  1989-06-20  |  16KB  |  380 lines

  1.  
  2.                                 DiskX  V2.0
  3.                                 -----------
  4.  
  5.                               by Steve Tibbett
  6.                               ================
  7.  
  8.  
  9. Index (sorta):
  10.  
  11.         Section 1: An introduction to what DiskX is all about.
  12.  
  13.         Section 2: The basics of DiskX © how to use it.
  14.  
  15.         Section 3: Features added to newer versions of DiskX (2.0, 2.1)
  16.  
  17.         Section 4: FastFileSystem - What it is, how it works with DiskX.
  18.  
  19.  
  20. A lot of this manual is in a sort of Chronological order - The newer info
  21. is at the end.  If you have already used an earlier version, you should
  22. check Section 4 and on.
  23.  
  24. ---------------------------------------------------------------------------
  25.  
  26.         1:      INTRODUCTION:
  27.                 -------------
  28.  
  29.  
  30. Hi there.
  31.  
  32. One day I was happily using DiskEd, the Commodore-supplied Disk Editor,
  33. when I realized that I wasn't really "Happily" using it.  The Amiga is
  34. a mouse-based graphics-oriented system.  DiskEd is designed to confuse
  35. everybody except the person who wrote it, unless you are willing to
  36. spend a good bit of time learning how to use it.  This shouldn't be.
  37.  
  38. Enter DiskX.  (the start of the Entire X-Series!)
  39.  
  40. DiskX's main purpose in life is to be a Sector-based Disk Editor (as opposed
  41. to a File based editor, such as FileZap).  DiskX can also be used as a
  42. file editor, how to do this will be discussed a bit later on.  (geez, this
  43. sounds like a manual, doesn't it?).
  44.  
  45. I suppose I should start putting those little title things in here so people
  46. know which parts to skip over:
  47.  
  48. Overview:
  49. ---------
  50. DiskX lets you view the disk in a block-by-block format.  It also gives
  51. you the capability to FIND strings of text anywhere on the disk, to find the
  52. First block of any file, to view each block either as the mass of Hex 
  53. numbers it really is, and the ability to view the block as what it REALLY
  54. is (i.e., File Header Block, User Directory Block, etc.).  The different
  55. block types there are can be found in the AmigaDOS manual by Bantam.
  56.  
  57.  
  58.         2:      HOW TO USE DISKX
  59.                 ----------------
  60.  
  61. What is a DOS DEVICE?
  62. ---------------------
  63. DiskX lets you look at anything that AmigaDOS sees as a device.  If you have
  64. a Hard Disk, there should be a hddisk.device, jdisk.device, or something 
  65. similar in your DEVS: directory on your workbench disk.  This also goes for
  66. the VD0: recoverable ram disk, which has asdg.vdisk.device there.
  67.  
  68. Note that the RAM: disk is NOT really a DOS device.  The Ram Disk is managed
  69. by the RAM-HANDLER in the L directory, thus making it ineligable (or
  70. inelegable or inelegible depending on whether you teach spelling or not).
  71.  
  72. Also, DiskX will not allow you to look at the PAR:, PRT:, SER:, NIL:, or
  73. anything else that isn't a device, because printers and modems don't like
  74. being asked to return a specific cylinder.
  75.  
  76. 1.3 NOTE: Workbench 1.3 (Gamma 4) includes a CARD: device.  In DiskX, you
  77. can use this © this is more like a DOS Device than the RAM: disk.  Just
  78. get the "Find File" requester up, and enter CARD: as the drawer.
  79.  
  80.  
  81. Modes of Operation:
  82. -------------------
  83. DiskX has two modes of operaiton, HEX mode and INTERPRET mode.  
  84.  
  85.  Hex Mode:
  86.  ---------
  87. Hex Mode will allow you to look at what is actually in the block, 256 bytes
  88. at a time.  If you are looking at the first half of the block, the offset
  89. will be less than 100 (in Hex).  The offset is displayed at the bottom right
  90. of the screen somewhere, and reflects the current position of the cursor.
  91.  
  92. The cursor can be moved around either with the mouse (Point and Click), or
  93. with the Cursor Keys.  Pretty simple, eh?
  94.  
  95. While in hex mode, hitting the return key will allow you to enter Ascii Text
  96. starting at the current cursor position.  Just move the cursor to where you
  97. want to start, hit Return, type in your text, then hit Return again.  Note
  98. that the cursor keys will not work when you are entering text, but the Mouse
  99. Pointer will still allow you to move the cursor.
  100.  
  101. When you are in Hex mode, there are a couple of extra Gadgets (the square,
  102. obnoxious-looking things) that pop up on the bottom of the screen.
  103. There's the 'Other Half' gadget, which will show you the other half of the
  104. block, there's the Modify gadget, which will let you edit the contents of
  105. that byte in either Hex, Decimal, or Binary, and then there's the Show Type
  106. gadget, which will flip you into:
  107.  
  108.  Interpret Mode:
  109.  ---------------
  110.  
  111. This is where the excitement lies.
  112.  
  113. In Interpret mode, instead of just showing you what is in the block as
  114. Hex, it tries to make some sense out of the block the same way AmigaDOS 
  115. does, showing you only the contents of the block that are relevant to that
  116. block type.  For instance, if the block is a Data Block, you will see the
  117. contents of actual DATA part of the block in the middle of the screen, and
  118. at the top of the screen you will see where that block's File Header Block is
  119. located, what it's Sequence Number is, where the Next Block is, and the Size
  120. of that block.
  121.  
  122. When you're in Interpret mode, a few other keys come into play, also depending
  123. on what type of block you are looking at.  The left and Right cursor keys
  124. will move up/down by one block.  
  125.  
  126. R will move you to that disk's ROOT lock.  P will bring you to that block's
  127. Parent Block (If it has one).  N will bring you to the Next block, if the
  128. current block type supports it.  W will tell it to Write the block back
  129. to the disk, and E won't do a darn thing.
  130.  
  131. Also, if the block type supports it, you will get either a "First Block",
  132. "Next Block", or a "Parent Block" gadget on the screen.
  133.  
  134.  
  135. Find:
  136. -----
  137. Find will let you search for a string of text.  Just type in the string,
  138. then select either to start from Here (the current Block Number), or from
  139. Block #0.
  140.  
  141.  
  142. Key # vs Block #:
  143. -----------------
  144. The terms Key and Block get used fairly often here - they both mean the exact
  145. same thing.  They refer to the current Block Number, which is how far into
  146. the disk we are in 512 byte blocks.
  147.  
  148.  
  149. Parent Block and Header Block:
  150. ------------------------------
  151. These two terms end up being used a good bit in the program - again, they
  152. both mean the same thing, they mean the block that this block is pointed
  153. to by. <make sense?>
  154.  
  155.  
  156. Getting Out:
  157. ------------
  158. All good things must come to an end, and you've got three ways to end it all
  159. from here:  Hit Escape, click on the Quit Gadget, or use the Quit menu option
  160. and you're out.
  161.  
  162.  
  163. Notes:
  164. ------
  165.  
  166. - DiskX will only work properly on devices which use a 512 byte block.  I
  167.   have yet to see one that uses a different sized block, so it didn't seem
  168.   like a big problem.
  169.  
  170. - If you want to change anything on your KickStart disk, there is a Public
  171.   Domain Program out there called SumKick, which will fix the checksum
  172.   on the KS disk for you after you've changed it.  Otherwise, whenever 
  173.   you Reboot, it will want Kickstart back.
  174.  
  175. Uses:
  176. -----
  177. After reading all this, you're saying "Great, but what will I use it for?".
  178. Well, here are some uses:
  179.  
  180.   If you live in Canada, (like all the real people in the world, eh?  Turn
  181.   the heat up, Bob.), you can take any program which refers to "State"
  182.   and change it to refer to "Prov." using the Find command.
  183.  
  184.   You can read the text in the Virus without ever allowing the Virus to load
  185.   into your machine by putting a disk with the Virus on it in the external
  186.   drive, and looking at Block #1 in ASCII mode.
  187.  
  188.   You can find hidden messages in your Kickstart disk.
  189.  
  190.   You can dig through your favorite game to find all kinds of strings which
  191.   may be helpful.
  192.  
  193.   You can waste a lot of time going through programs which hide any ASCII
  194.   text contained in them.
  195.  
  196.   Using the Write Block to File option, you could take any auto-booting
  197.   disk (the kind that uses the boot sector to load the game), write it
  198.   to a file, and disassemble it or whatever.
  199.  
  200. ----------------------------------------------------------------------------
  201.  
  202.        3:       NEW FEATURES
  203.                 ------------
  204.  
  205.  
  206. New Features in DiskX 2.0:
  207.  
  208.  - It now works with ANY DOS device, include Hard Disks!
  209.  - Ability to Search the disk for ascii strings without being case-sensitive.
  210.  - Ability to recover a deleted file from any device.
  211.  - Ability to view ALL ascii strings on the disk, in a simple manner.
  212.  
  213.  
  214. Using other DOS devices:
  215. ------------------------
  216.  
  217. DiskX will now read the DeviceList and find any device you are using in
  218. the system (if it is a Block-based device).  If your favorite device isn't
  219. on the "Unit" menu, here's how to get it:  Bring up the "Find File" requester
  220. (from the Project menu), and type in the device name into the Drawer area.
  221.  
  222. That should do it - if you go for "Disk Info" (on the same menu), you will
  223. see info on it.
  224.  
  225.  
  226. Case Independent Search:
  227. ------------------------
  228. When you go to Search (using the Find... gadget on the main screen), if 
  229. the first character of the pattern you are searching for is an
  230. Asterisk ("*"), it will ignore the case of the string it is searching for.
  231. (If you tell it to search for *Hello, it would find Hello, hELLO, HeLlO, or
  232. any other variation).
  233.  
  234. If the first character of the pattern you enter to search for is an 
  235. "@" (at sign), DiskX will treat this as though you were looking for a 
  236. file name - it will ignore case, and will only stop at blocks which are
  237. file headers whose filename matches this pattern.  More on this later.
  238.  
  239.  
  240. Searching for Text Strings:
  241. ---------------------------
  242. You can now search the whole disk, starting at either block Zero or from
  243. the current position, for ANY ascii text (It will display any text
  244. string longer than 6 characters).  It's a menu option.  Also, if you
  245. select the "Through Links" option, you can start searching from a file
  246. header (using the "Find File Header" menu option to find the file header)
  247. to search through a particular file for text.  Also, take a look through
  248. the Kickstart disk - there's lost of neat stuff on there.
  249.  
  250.  
  251. Recovering Files:
  252. -----------------
  253. You've just deleted a file.  The file's name is LostFile, and it is on
  254. DH0:.  Here's how to get it back:
  255.  
  256. 1.  Select the DH0: menu option on the Project menu (in the Unit Number
  257.     submenu).  Same thing applies for any device.
  258.  
  259. 2.  Click on the Find... gadget on the bottom of the main screen.  Tell
  260.     it to search for "@LostFile".  This will find LostFile's file header
  261.     block and make it the current block.  (Remember that the @ sign tells
  262.     DiskX that you're looking for a file header) (You will probably have to
  263.     hit the "Show Type" gadget to get it to tell you that it is a file header,
  264.     as after doing a Search, DiskX defaults to Hex mode) (Not any more!).
  265.     Note that doing a Find on a hard disk can take a good bit of time.
  266.  
  267. 3.  Select the "Recover..." menu option..  DiskX will now search through 
  268.     the entire disk for any block whose Parent block field points to the 
  269.     file header for LostFile (any block belonging to Lostfile).
  270.  
  271. 4.  When it's done, there will be a file requester asking you where you
  272.     want the file to be written to.  DO NOT WRITE THE FILE TO THE SAME
  273.     DEVICE YOU ARE RECOVERING IT FROM.  While the chances are you 
  274.     won't have any major problems doing it, things could go wrong.  A safe
  275.     place to write to is the RAM: disk, and it's the default drive when
  276.     this requester comes up.
  277.  
  278. 5.  After you've entered the new name for the file here, hit OK (or hit
  279.     return), and the file will be recovered.  That's it.
  280.  
  281.   It sounds like a lot of work, but after you've done it once, it's actually
  282.   pretty easy.
  283.  
  284.  
  285.     New Features to 2.1:
  286.  
  287.      Bug Fixes: No longer writes back to wrong HD partition
  288.      Support for Interlaced screens.
  289.      
  290.  
  291.      ->  Any other ideas?  What would YOU like in a disk editor??  <-
  292.  
  293.  
  294. ----------------------------------------------------------------------------
  295.  
  296. Another new feature:
  297.  
  298. On the special menu, there is an option to write the current block to
  299. a file.  The first time you select this option, you will be asked for
  300. the filename you want to write the data into.  Each time you go for
  301. this option after that, it will write the block into the same file (If
  302. you haven't closed it already).  If you plan to write a number of blocks
  303. during the same session (say to write the 2 boot blocks into a file so
  304. you can disassemble it), just don't close the file after each write, wait
  305. until you have written all you want to write, and then close the file.
  306.  
  307. If the block you are writing is a Data Block (part of a file), only the
  308. data part of the block (488 bytes) will be written, otherwise all 512 bytes
  309. (including the block's checksum) will be written.  
  310.  
  311. If you forget to close the file before quitting, DiskX closes it for you.
  312.  
  313. -----------------------------------------------------------------------
  314.  
  315. If you own a device other than the ones listed on the Unit menu, 
  316. to get to it, use the Find File Header command.  Enter the device name
  317. you want to get to into the Drawer gadget, and nothing in the filename
  318. area.  Hit OK, and you should be there.
  319.  
  320. -----------------------------------------------------------------------
  321.  
  322. DiskX should now work correctly with HD partitions - If it will read from
  323. it properly, it will write to it properly.  It also takes into account
  324. the area at the beginning of some drives for mapping bad sectors into -
  325. it won't redirect the bad sectors to there, but it will ignore that space.
  326. Anyways, on some drives, it gets confused as to where the root block is.
  327.  
  328. If when you first select the drive, the block you see is NOT of type
  329. Root Block, you are going to have to go up or down a cylinder or two
  330. to find it.  It's just a minor hassle - also, the "Disk Info" menu option
  331. will show the Disk's name wrong.
  332.  
  333. -----------------------------------------------------------------------
  334.  
  335. Note that DiskX becomes a lot nicer to use (if you use it a lot) if you run
  336. one of the Text speedup programs available (BlitzFonts, FastFonts).  
  337. BlitzFonts is a good candadate, since it's a PD program.
  338.  
  339. Note that DiskX now has FastText built in, so you can ignore the previous
  340. paragraph 8-)
  341.  
  342. -----------------------------------------------------------------------
  343.  
  344. Plea to your good nature:
  345. -------------------------
  346. Y'know, folks, this Amiga device is great, but nobody seems to be able
  347. to make anything cheap for it.  I'm just about to pay $1400 (in Canadian
  348. bucks - ouch) for a hard drive, and, well, I could use some form of
  349. $$ for this program.  I was looking at Sectorama recently, (Nice program
  350.  - I stole a bunch of ideas from it for here), and I think I'm going
  351. to steal something else from it:  His idea of compensation for a 
  352. "Freeware" program.  
  353.  
  354. If you like DiskX, you can either do Absolutely nothing about it and just
  355. hope I manage to stay alive and keep making these things, or you can do
  356. something about it.  What you can do is either send me some cash, which
  357. I really wouldn't object to, or, send me something you've written.  
  358. Anything.  If you're a developer, well, I probably couldn't afford to BUY
  359. whatever it is you're developing anyways, and it wouldn't cost you much
  360. to make me happy... <grin>
  361.  
  362.               Steve Tibbett
  363.               2710 Saratoga Pl. #1108
  364.               Gloucester, Ontario
  365.               CANADA K1T 1Z2
  366.  
  367.     (You can get me on 2 BBS's:  OMX at 613-731-3419, and
  368.                            Ottawa Online at 613-237-4701.
  369.     I'm on BIX, too, as "S.Tibbett")
  370.  
  371. I mean, hey, I got 3 (count 'em, THREE) letters from people who liked the
  372. original DiskX.  It wasn't THAT bad, was it?
  373.  
  374.  ...Steve
  375.  
  376.  
  377. (Another note - DiskX now builds the list of devices dynamically when the
  378. program is first run.  It will find ANY device that it can get at, and 
  379. put it in the Unit menu.)
  380.